home *** CD-ROM | disk | FTP | other *** search
/ Aminet 8 / Aminet 8 (1995)(GTI - Schatztruhe)[!][Oct 1995].iso / Aminet / util / misc / find361.lha / find.doc < prev   
Text File  |  1995-07-19  |  8KB  |  163 lines
  1.           ============================================================
  2.            $VER: find.doc 36.1 (19.7.95) Copyright (c) Ralph Seichter
  3.           ============================================================
  4.  
  5.  
  6. DESCRIPTION
  7.  
  8.    I wrote 'find' because I needed a tool to find files (obviously :) which
  9. match a given name pattern. 'find' is able to search multiple directories,
  10. including all subdirectories, the current directory and its subdirs, or the
  11. current CLI command path only. The output can be formatted in a way which
  12. tries to imitate 'List LFORMAT' behaviour, and you can make 'find' create
  13. shell scripts for you and execute them on the fly.
  14.  
  15.    Please note that 'find' is pure, you can make it resident. As it is less
  16. than 3 KB in size, this is recommended. Requires 'dos.library' V36 (OS 2.0)
  17. or better.
  18.  
  19.  
  20. COPYRIGHT NOTICE
  21.  
  22.    This program is Copyright (c) 1995 Ralph Seichter, all rights reserved.
  23. You may however freely use it and give copies to your friends, as long as
  24. you don't add data to or remove data from the distribution archive. You may
  25. *NOT* include any part of the distribution archive in a commercial software
  26. package. If you have comments or suggestions, feel free to contact me. Use
  27. PGP-encrypted Email when possible, you can find my public key at the end of
  28. this file.
  29.  
  30.         Ralph Seichter           Email: zodiac@darkness.gun.de
  31.         Am Christenrain 12       Phone: +49-2667-969000
  32.         56479 Stein-Neukirch
  33.         Germany
  34.  
  35.  
  36. USAGE EXAMPLES
  37.  
  38.    Locate all C source files on partition DH1:
  39.    -> find #?.c dh1:
  40.  
  41.    Find all Icons in the current directory and all its subdirs, but
  42.    don't display the ".info" suffix.
  43.    -> find #?.info lformat %m
  44.  
  45.    Get rid of all files with the prefix "foo" on some partitions, but
  46.    don't go deeper than three subdirectory levels while scanning.
  47.    -> find foo#? sys: dh2: bozo: depth=3 lformat="delete %p%n" exec
  48.  
  49.    Find 'Type' in the command path.
  50.    -> find Type path
  51.  
  52.    Find all occurences of 'bar' in the command path.
  53.    -> find bar full
  54.  
  55.    I hope that these few examples show some of the potential of 'find'. The
  56. possibility to create shell scripts and have them executed without further
  57. interaction is certainly very useful for many tasks.
  58.  
  59.  
  60. COMMAND TEMPLATE
  61.  
  62.    PATTERN/A     Any OS name pattern, i.e. "#?.info".
  63.  
  64.    DIRECTORY/M   List of directories to scan. If omitted, only the current
  65.                  directory and its subdirectories will be searched.
  66.  
  67.    DEPTH/K/N     Number of subdirectory levels (recursion depth). DEPTH=0
  68.                  means no subdirs, DEPTH=1 one subdir level, and so on.
  69.  
  70.    LFORMAT/K     Format string. You can use a subset of the templates known
  71.                  from 'List LFORMAT' to modify the output. As an example, a
  72.                  file called "dh0:foo/bar.c" shall be used.
  73.  
  74.                     %e   Name suffix            .c
  75.                     %f   Full path and name     dh0:foo/bar.c
  76.                     %m   Name without suffix    bar
  77.                     %n   Full name              bar.c
  78.                     %p   Fully qualified path   dh0:foo/
  79.                     %%   Percent sign           %
  80.  
  81.                  LFORMAT defaults to %f (full path and name).
  82.  
  83.    EXEC/S        Create shell script using the given LFORMAT string. You
  84.                  must specify LFORMAT, or EXEC will be ignored.
  85.  
  86.    FULL/S        Check full command path instead of stopping with the first
  87.                  match (FULL implies PATH).
  88.  
  89.    PATH/S        Find first matching file in the current CLI command path.
  90.  
  91.    VERBOSE/S     Print the names of all directories when they are scanned.
  92.  
  93.  
  94. DISCLAIMER
  95.  
  96.    THIS MATERIAL IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
  97. EXPRESS OR IMPLIED, STATUTORY OR OTHERWISE, INCLUDING WITHOUT LIMITATION
  98. ANY IMPLIED WARRANTIES OF NONINFRINGEMENT, MERCHANTABILITY AND FITNESS FOR
  99. A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE USE, RESULTS, AND
  100. PERFORMANCE OF THIS MATERIAL IS ASSUMED BY YOU AND IF THE PRODUCT SHOULD
  101. PROVE TO BE DEFECTIVE, YOU ASSUME THE ENTIRE COST OF ALL NECESSARY
  102. SERVICING, REPAIR, OR OTHER REMEDIATION.
  103.  
  104.  
  105. -----BEGIN PGP PUBLIC KEY BLOCK-----
  106. Version: 2.6.2i
  107.  
  108. mQBNAi7dDgAAAAECANd1hBXK8RLHVmJxmhuq6hFS1HBIPHC7YImTZFs10d3FfQFe
  109. 63xBabCJxzQh06ODARdYuE7i9PfKqxQX9aw2mMEABRG0J1JhbHBoIFNlaWNodGVy
  110. IDx6b2RpYWNAZGFya25lc3MuZ3VuLmRlPokAlQMFEDABpzFP7Zu19QzSjQEBTjAD
  111. /RXsUrWM8Eh8h0vU/b8d/unRqhIxTNHQIuKbHVJl0AQhr6KixvQYXTyof6d28CEM
  112. bd01WgGQ0OopBo3C/aorCpXgcxUwzYDm6MtDU6+uG/KoHyiBRBcke1DHkZQJn6a2
  113. 0YPwwoota1YoLeRvLFLbFWenSzmvoy3at2q/TcKGP8XFiQCVAgUQL/cb1hzyDad0
  114. m4cRAQEwkQP9HoOvMRIy+27kugz1ptAichDWnbtGhYZ1nerv7W4AIohseStt6YQa
  115. 37XaUOs1a9KQfoieNr+BtDEPHM8SFwz1a/A2c1dmt9P+GJmK8vy4JY4F/++xVi5C
  116. nZmL5GD0DqEx5Or5bMQ57YhJXWKFJfPHopDVrK5uM3jTl+IWYQY+qyiJAJUCBRAv
  117. jU5cws1y1OXZar0BAfp9BACuL/c+e2iZL8pENGfpBNuhWIx+CtYBhIzUSfv93k4+
  118. KSlDYjNZJU6+1vK2Je2qPSEDyezEJWlc/H93j16uusXLe/uhdtLpIKhonIbhtFF9
  119. z8g6hrO6k5Vd/E+w7F0vnY5ogNKb2D8aJXmx/9I35mpn8DTrxMmoq5Y2h6+I36Qx
  120. 7YkAVQIFEC9bXPCHwY+Q4sBudQEBvAcB/2/iWYkdlblArBAL+4h/U7sP6S9ZAXja
  121. 1EuckLhAKS2Bg2im0dGqTwAjrJI3eGGukW4xwlj3ovVMiUcpzJYrnZOJAJUCBRAv
  122. DJBMl60DD8dpzlUBAa05A/4plkZiNGzGYoJYCNLaE5fnITff6JnImld9VP8tPS8x
  123. G7eNakMu2yIHNAS/Ec6I0Wgk9Pm36X1ChfChSHN+wFMCGrrsUIOx7d/JhAtZTazJ
  124. hAYYA0bqiK8uBZ90seOghzNXgLTS0fQafRC+Maxj3A08+SoVd8kOkjEQ1J4FWP2Q
  125. QokAlQIFEC7yMAlV6of8X2TfTQEBnxgEAM5OtwWEKMX78dm8U4SDtgluOV3L51nE
  126. r5yZvcsgQJracLFgUA09vH6JacsEcQE7F0Mse2j6hZffDF9705UD1iFUz6hIyKM1
  127. JYwI5wof7fxAngO5kq2fPbiSMwyGdhaRriMssJSITUi620yqyRamkw7bZdB5KSM2
  128. 91eALzjTBmsdiQCVAgUQLunqddpSWdA6Wiz5AQH8YwP+PCGnsfNoX2NiywQDkozm
  129. qn61W1Dl/hCMauSWBN0W9HBXwzHKbFxv46hsRFg3F9gBhJn+eXfA2/oavYkXemIZ
  130. 4U2QYjclvBsNIiHhMfmJTuAdqRG+hivXUzlWj6B8ZHmehkd0cv3FbkUyNoTeiEA8
  131. iNiBhns1M7c1y5/n7fYucYuJAFUCBRAu4vT2ESzR/5V9gRkBAUvUAgCutse+u+5L
  132. 9OYlEvXGLI6F4mhb71FS8y9laco+jEUPzpks5o9/ueSa9hrYkwIAy323EzOPvx11
  133. 4VRgqnx12EuCiQCVAgUQLuTHLKdokTwi9RJ1AQEp3QQAlAMv3vi2B8Iga0dREOxO
  134. lZNJSg1UNvE/RDQqWXqY8javl+TS1za9SyCmTsXHECq4PIhoFcvPbj+1S9a1yYLJ
  135. G557LfKCWdv3euR5xP5RL8eGGVL++zvQa8AwVj3BQ6KbaiLPF88JAycSlyjX5Xpv
  136. CNARbSkyON5wBcQWnpoJx+iJAJUCBRAu4HS9EK7Ev9lsN9EBARSKA/4lmIwXw3k/
  137. AMEnKCnGX774yv/iWEaUITpciHm6+KTFntSY3cp30/MTsaEd8dN33HKECprjXwm8
  138. 6HN88WTonQs7KTNVlmHNT+JzO76wzsS34iSycmfCWGwlTbF2VfAnnJw05u4Hr5CY
  139. zEy81yLTtArD9lzJ8W9MA9MWAs7FmNgEw4kATQIFEC7f4UN2ANz5hpOI7QEBbvcB
  140. vAtPh95pX31fX6M9BzbQFtxboQ7qhd2HCLP9eUd5Avy/0JLuS3BrtubNR+kUhO8+
  141. qG1Mju+y4C3AiQBVAgUQLt9JybCkoil+6zDVAQFybQIAkZjlSKx29eXRdtbBNZ16
  142. VczIXOqcmReYPUJsTjCVVKWRiNYCJ3xs8kFkr2ziBDjsRCbfTv/ZQvFutdS0LtzN
  143. lokAVQIFEC7eJzl2li8dQZQFqQEBn1ECAJsbrf2xC6WeIyb0YR24AuiLfrKVqCIt
  144. YBftn2G4QlybYNJc95GCPXgrOcls3Fq1l8aunTwcsl+R8pMEO2n9DbKJAHUCBRAu
  145. 3itQVRxnsIOQKL0BAY0PAwDD5q8iXhJGK0/nvS2eOVBXlzP1XsekvNUpBqO4dc45
  146. gaZGc6C/vcj35WAl8k2IriuuA0JLKaxuslO1HJQ0T1AFe04gNSR4+T6C4RFmGEMV
  147. TIh2f7YQVwoaou7ATp67ZUyJAJUCBRAu3jgNldACPAwYESEBAf7MA/9b+6IkE7hN
  148. aA5aSeaeQ9flU2h692er9dUBG7Be06bGA7tgC5vXTVcCp/VEfdV3pIG6lZddVvov
  149. EKcxx/kfQgafTxKLrQHUBnaatI7LhSYm8rSbs95orBdU8L0bOdcZ64JXRW0ZjWX1
  150. A5N76xZC4SnTHbOS8jnGNA3tNQ0u7ViavIkARQMFEC7edzlyl+6zH/tU/QEBHPkB
  151. ewXkxc0fNjv3XZPSnFUoFhWBs/3w1msw3Xid/uzmpOjpJ8Rfo3KzbcyO8+apZhqH
  152. jYkAVQMFEC7dkWOyYDVm5vtn0QEBT7MB/R6py7BXYhOnHlkrwTcWf8k05H1RAmbz
  153. Uo1dZaTy0mHsk5WFf4WaHWtq6dgjJc839BQwQ/fj52nZGnxOH/OmVQaJAFUCBRAu
  154. 3Q7DqxQX9aw2mMEBAU0pAf4hbVzdfNYeQibY7lnqO9Lg4k2kLbT57752g+CDcAKc
  155. VRsMhXEaKt8N+yfAeGuOsTDgLGOf7JT3NU5UKJmyAIqntDBSYWxwaCBTZWljaHRl
  156. ciA8c2VpY2h0ZXJAaW5mb3JtYXRpay51bmktYm9ubi5kZT6JAFUCBRAvgEf7sKSi
  157. KX7rMNUBAdRFAf9ciI3hOA+l0f0l41ktNfbpbbRxFZvjKoQwWe2id3GsXrEEqvWa
  158. E7gwrXE9rQffW170BXPeTWT+hcE8dzrMFQHdiQBVAgUQL3vqwqsUF/WsNpjBAQEm
  159. lgH+JcLWxvay8lj9mi6vd10028TcIiePdNenZR5pwN0xWrCcPfYTjCmKQwAGDZI/
  160. WntTEZOpptykjMUc+SWZW3yJcA==
  161. =bkXv
  162. -----END PGP PUBLIC KEY BLOCK-----
  163.